Short:    Tool library. Gadgets,text,converting +
Author:   Kenneth C. Nilsen (kenneth@norconnect.no)
Uploader: Kenneth C. Nilsen (kenneth@norconnect.no)
Type:     util/libs


dfunc.library ver. 37.14


Manual
======

	dfunc.library

	Copyright © 1994, 1995 by Kenneth C. Nilsen/Digital Surface.
	All rights reserved.

	This library is freely distributable as long as no charges is made
	except from a little fee covering media expenses.

	This archive is allowed to be distributed with the Fred Fish
	collection, AmiNet, BBSes and PD libraries.

	Feel free to use it with your own application. I'll feel happy if you
	credit my work. Not allowed to be used with commercial software
	without a written permission. Shareware authors can also use it, but
	not without a deal (I am not greedy though).


	The library requires v37 and 68000 to run.


About
=====


This library is a multipurpose library.  It covers aspects from low functions
to functions rendering graphics, gadgets and texts.  For use with interactive
programs, multimedia programs, utilities and entertainment.

The  gadgets  are powerful, fully scalable and allows customizing and images.
The  gadgets  can  start processes independed on the main program, has a mask
field which is useful with interactiv application and eg.  games.

It  has  many  powerful text routines, for example the DFStripText() function
which  stripps  any  type  of  comments.  It has also text rendering routines
where  you  can  give  a  pointer  to  a normal text file and print it in the
rastport  centered or not, of a window or to printer directly.  It will later
support ansi texts.

It has most function needed for making life easier.

It is 100% system friendly and it's written in assembler to make speed affort
and small size.

It contains example sources.

It is freeware!



Notes
=====


It  contains  full  developer  information.   One  note thow:  The autodoc is
written  after  the  library  was  written.   That  means there might be some
mistyping,  wrong  explinations  and  the C prototypes are not correctly yet.
This  is  the  first beta version of the autodoc so don't blame me yet.  It's
anyway useful for most programmers.

I  correct  all  this  faults  in  a  later version.  Boy one get tired of an
autodoc after writting 80K text...

I have also used "struct gadlist *" in the C prototypes.  This is not correct
since  the gadgetlists are not a structure.  Will be corrected along with all
the other C prototypes errors (wonder why I am programming assembler ;).



Archive
=======


This  archive  contains BETA version of the library.  That means there may be
some bugs in the library and/or bad explinations in the autodocs.

Most private functions are not explained and they don't have to be. :)
See the FD file file for PRIVATE functions. They may change in new releases.



Explainations
=============


"List of gadget structures" (<input> in the autodocs)

	This is one of the powers with this library. You can set up a list og
	gadget structures after each other and end the list with a -1. In
	this way you don't have to mess around with complicated routines to
	set up system gadgets. See example sources to see how this is done.



Overview
========


The library is still at its beta stage. I haven't had time to test all
functions, but I haven't discovered major bugs yet.

Please report any kind of bugs you find via e-mail.

Questions about the usage?  E-mail me and I'll be happy to explain.

I  am trying to use the registers so they will be easy to remember.  I always
start  with  the  lowest register number and uses Ax regs for pointers and Dx
for  flags,  options  and values.  The regs start with 0 from left and the fd
are sorted so the address registers start first.  Example:

Example(Buffer,Text,FileName,size,options,mask) will have this reg layout:

(a0,a1,a2,d0,d1,d2)



Author
======


To report any bugs, critism, questions :


	e-mail: kenneth@norconnect.no


	Digital Surface
	attn: Kenneth C. Nilsen
	Kvernhusrenen 31
	N-5227 S-Neset
	(Norway)
